home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / rem_acc / ublst102.zip / UBUZLIST.DOC < prev    next >
Text File  |  1996-04-11  |  11KB  |  245 lines
  1.                          Ubuz Lister 1.01
  2.              Copyright (c) 1995-1996 T-Ras Multimedia
  3.                    Written by Iftach Silberman
  4.  
  5.  
  6.  
  7. Ubuz Lister is a program I wrote because I needed it. I moved to RA's
  8. internal file base structures, and I really needed a program that can
  9. display files in a reasonable manner. Thus came Ubuz Lister to life.
  10.  
  11. Installing Ubuz Lister is simple. The program does not need any
  12. configuration files and it gets all the information it needs from RA's
  13. exit files. All you must do is set your RA environment variable to use
  14. Ubuz Lister, unless RA's configuration files (*.RA) can be read from
  15. the current directory.
  16.  
  17.  
  18. Setting up
  19. ----------
  20. Set up Ubuz Lister as a menu option the way:
  21.  
  22. Action   Execute sub-program (Type 7)
  23. OptData  C:\RA\UBUZLIST\UBUZLIST.EXE *X *M
  24.  
  25. The *X is required to allow file tagging. The *M is not required, but
  26. recommended.
  27.  
  28.  
  29. Command line options
  30. --------------------
  31. /T - Allow tagging. Without this parameter the users will not be able
  32.      to use the tagging option of Ubuz Lister.
  33. /N - New files search since last logon or from a specified number of
  34.      days back. New files will be scanned according to the file date
  35.      and upload date.
  36. /S - File name search.
  37. /K - Keyword search.
  38. /FG - Restrict all searches to current group of files.
  39. /FG=xxx - Restrict all searches to group number xxx.
  40. /FA=xxx - Use this parameter to make Ubuz Lister view an area
  41.           different then the current chosen area.
  42. /NL - No kb and file ratios limit checking. When this switch is set
  43.       on, Ubuz Lister will allow tagging of any number of files.
  44. /NS - No Status line. With this parameter you can disable the SysOp
  45.       status line by defualt.
  46. /FIC - Force the file searches to the current file area.
  47. /FIG - Force the file searches to the defined group.
  48. /FIA - Force the file searches to all the file areas. If the search
  49.        was limited to a group, the search will be limited to that
  50.        group as well. In that case it will be identical to /FIG.
  51.  
  52. Ubuz Lister must be run from the directory RA exits to, because it
  53. reads EXITINFO.BBS, DOOR.SYS and TAGLIST.RA, and these files are found
  54. there. If you wish to run Ubuz Lister in a batch file, you can define
  55. the directory in which RA stores these drop files by adding /D:<path>
  56. to the command line.
  57.  
  58. The file UBUZLIST.BBS contains all the help screens, and must be
  59. present in the directory in which UBUZLIST.CFG is. If you do not use
  60. UBUZLIST.CFG, make sure the file is at on of the followin places:
  61. A. Current directory. B. The directory from which Ubuz Lister is
  62. executed. C. The directory defined by the environment variable
  63. UBUZLIST.
  64.  
  65.  
  66. Using Ubuz Lister
  67. -----------------
  68. When your users run Ubuz Lister, they see a simple menu and status
  69. line. All the commands appear on that line, and the user can use a
  70. help screen. You, as a SysOp, will get a status line informing you who
  71. is the user, what is his speed and port and how much time he has left.
  72.  
  73. Ubuz Lister uses as much info as it can from RA's configuration so you
  74. have less to worry about. The archive viewer definition is read from
  75. CONFIG.RA, the user information is read from EXITINFO.BBS and the file
  76. areas information is read from FILES.RA.
  77.  
  78. You can configure Ubuz Lister's advanced options as described in the
  79. sample UBUZLIST.CFG file in this package. The options are pretty
  80. simple and straightforward. Ubuz Lister will look for UBUZLIST.CFG in
  81. the current directory. If it cannot find it there, it will look for it
  82. in the path specified by the environment variable UBUZLIST. If it
  83. cannot find it there or if the variable is not defined, Ubuz Lister
  84. will try and find the file in the directory from which is was run. If
  85. this fails too, Ubuz Lister will use its defaults.
  86.  
  87.  
  88. SysOp keys
  89. ----------
  90. These keys are available for the SysOp only.
  91.  
  92. F1 - turn the SysOp status line on / off.
  93. Alt-X - Exit the program.
  94. Alt-H - Hang up the user.
  95. Alt-J - Shell to DOS.
  96. Alt-C - Chat with the user. You can use the chatter defined in RA's
  97.         configuration or you can force Ubuz Lister to use an internal
  98.         chatter.
  99. Alt-Fx - These keys will be used according to the function keys
  100.          defininations in RACONFIG. Ubuz Lister supports the following
  101.          command line macros:
  102.  
  103.          *B  User's BPS connection speed.
  104.          *C  Full path and name to COMMAND.COM.
  105.          *F  User's first name.
  106.          *G  The user's current ANSI graphics setting.
  107.          *L  User's last name.
  108.          *M  Activate the MemorySwap feature.
  109.          *N  The current node number.
  110.          *P  Communications port being used (1 - 8).
  111.          *T  Time remaining (in minutes) for the current call.
  112.          *0  The full path to the currently selected file template area.
  113.          *1  The number of the currently selected template message area.
  114.          *!  Suspend time.
  115.  
  116.          The rest of the macros will be ignored. In this version Ubuz
  117.          Lister swaps automatically, so the *M macro doesn't actually
  118.          matter. If you want an option not to swap, please notify me.
  119.          Time suspension will be effective if you use Ubuz Lister as
  120.          type 15 menu option - exit with error level. I'm not sure if
  121.          RA reads EXITINFO.BBS when returning from a shell. Ubuz
  122.          Lister will suspend the time, but RA might ignore this and
  123.          throw away the user after Ubuz Lister finished.
  124.  
  125.  
  126. Known problems
  127. --------------
  128. 1. RA does not read its tag file the same way it writes it. This is a
  129. bug no one noticed so far, since there weren't many programs that use
  130. this feature. The problem is that when RA reads the tag file, it gives
  131. all the free files a size of 0 bytes. This can be problematic since RA
  132. cannot calculate the correct download time. Another problem occurs
  133. when someone untags free files and gets a negative kb value. This bug
  134. was fixed with RA 2.50.
  135.  
  136. 2. DISP tag file - The DISP format supports only the file name, with
  137. no referance to its directory/file area. This can cause problems if
  138. you tagged two files with the same name in different directory.
  139. Currently Ubuz Lister will work both with RA's tag list and with DISP
  140. tag list, and if you want a reliable update of which files were
  141. downloaded you must work with both. Basically, Ubuz Lister works with
  142. RA's tag file but if it finds a DISP tag file it will remove all the
  143. files that do not appear in the DISP tag file from RA's tag file.
  144.  
  145. 3. The SysOp status line can confuse the SysOp when tagging or
  146. viewing. The problem is that on the local screen the line may cause
  147. the display to scroll, and hence the position of the file names will
  148. be wrong. On the remote terminal things will appear just fine, but not
  149. on the local screen. Two solutions are possible: A. Disable the status
  150. line. B. If you use Ubuz Lister locally allot, make sure your screen
  151. definition in RA is one line shorter than your screen size.
  152.  
  153. 4. File locks. Some programs, like RAMGR, think they own the computer.
  154. When such a program is run in one session, others cannot acces the
  155. opened files, namely FILES.RA and FGROUPS.RA. In UBUZLIST.CFG you can
  156. define file name that Ubuz Lister will read instead of FILES.RA and
  157. FGROUPS.RA. These files will simply be a copy of the originals, and it
  158. will be your responsibility to copy the originals over the new files
  159. whenever you update a file area or group information. This is a very
  160. simple procedure, but it is a must and you must do it if you want Ubuz
  161. Lister to work properly. You will not have to update these two file
  162. every time a new file is added to the system or moved between two
  163. areas, but only if you change the file areas and groups themselves.
  164.  
  165.  
  166. RA 2.50
  167. -------
  168. Ubuz Lister works fully with RA 2.50g1. Version 1.0 did not go through
  169. thorough testing under 2.50, hence came 1.01. All the 2.50 related
  170. problems were fixed in 1.01.
  171.  
  172.  
  173. Legal stuff
  174. -----------
  175. Ubuz Lister is a shareware. This means copying the program does not
  176. require any fee and the program can be copied to anyone as long as you
  177. copy the original archive. The only fees allowed are shipping and
  178. handling fees.
  179.  
  180. The author is not responsible for any damage that may occur by the use
  181. or misuse of this program. This program is not guranteed to do
  182. anything besides occupying disk space. Backup frequently! Trust no
  183. one! The truth is definetly out there, but you'll never find it by
  184. watching X-Files.
  185.  
  186.  
  187. Shareware
  188. ---------
  189. Yes, Ubuz Lister is shareware. Registering Ubuz Lister doesn't give
  190. you anything, except for the knowledge you helped supporting this
  191. program. Registration is $20 for systems with up to 4 lines, and for
  192. systems with more than 4 lines registration is $5 a node. As mentioned
  193. before, registration will not give you any added features since Ubuz
  194. Lister is not crippled or slowed down in any way in its original form.
  195. The only exception is customizable help and credit screens. If you
  196. want me to change the colors or contents, register. :)
  197.  
  198. If you feel $20 is too much for you, send me a postcard, explaining
  199. how guilty you feel not being able to pay those $20. What is $20? The
  200. beer would have cost you more!
  201.  
  202. My postage address is:
  203. Iftach Silberman
  204. Kibbutz Kfar Szold 12230
  205. Israel
  206.  
  207. You can also get me in Fido netmail at 2:406/113 or preferably at the
  208. email address iftach@netvision.net.il.
  209.  
  210.  
  211. Credits
  212. -------
  213. Ubuz Lister was written using:
  214.  
  215. - ExecSwap Version 1.3, Copyright (c) 1988 TurboPower Software
  216.  
  217. - JSDoor v1.30a Gamma for Turbo Pascal v7.0 & v6.0
  218.   Copyright 1994, All rights reserved.
  219.   By John Stephenson.
  220.  
  221. - Borland Pascal Version 7.0 Copyright (c) 1983,92 Borland
  222.   International.
  223.  
  224.  
  225. Ubuz Lister was tested on the following systems:
  226.  
  227. Israel:                             Holland:
  228. -------                             --------
  229. Northern Exposure                   sl1210 BBS [Ch:ilm]
  230. Big Brother [Ram-on Agmon]          Yiehaaa [Phonc(ie)]
  231. The TombStone BBS [Dotan Peltz]     Overdrive [Mad Max]
  232. Discordia [Assaf Amit]              The Legend [WishBone]
  233. The Twilight Desert [Guy Rosen]
  234. Byte Quest [Avi Shatz]
  235.  
  236. Many thanks to the faithful users who suffered through all of its
  237. bugs.
  238.  
  239. Many thanks also go to Ram-on Agmon who pushed me into fixing the bugs
  240. and adding features, and to Danny Ruff, Dotan Peltz, Guy Rosen and
  241. Joost Baaij for their suggestions. I like to thanks Assaf Amit for
  242. writing the DIZ description - I couldn't have done it better myself.
  243. Last but not least, Amir Ubuz, without whom the program would have
  244. probably had a different name.
  245.